home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 18 - Serious (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 18 - Serious (19xx)(Topik Public Domain)(PD)[WB].adf / Qed / Qed_Intro.doc < prev    next >
Text File  |  1989-10-01  |  13KB  |  276 lines
  1.  
  2.  
  3.  
  4.  
  5.                                      QED
  6.  
  7.                               AMIGA TEXT EDITOR
  8.                                    REV 1.0
  9.  
  10.                      Copyright 1989 by Darren M. Greenwald
  11.  
  12.                               All rights reserved
  13.  
  14.  
  15.  
  16.  
  17.      QED may be freely distributed.  It may not be distributed in any
  18. commercial product, shareware product, or commercial publication without
  19. permission.  It is permissible to release QED as part of a public domain
  20. collection, or on a telecommunication service as long as no "special
  21. charge" is made for this program; "special charge" does not include
  22. "reasonable" charges for replication of the media, or standard charges for
  23. use of the system. 
  24.  
  25.      The intent of the above should be clear - I did the work, and while
  26. you are allowed to freely distribute the program, you may not profit from
  27. it.
  28.  
  29.      If you are interested in releasing QED as part of commercial, or
  30. shareware venture, I can be contacted at the address below.  Many programs
  31. could benefit from an integrated text editor, so it may also be possible to
  32. arrange a customized version of QED tailored to interact easily with your
  33. product.
  34.  
  35.      Any archived files which the author distributes MUST be left intact. 
  36. If you do distribute this program, I insist that you distribute all the
  37. files including any notices.
  38.  
  39.  
  40. DISCLAIMER:
  41. ---------------------------------------------------------------------
  42.  
  43.      In no way can the author be held responsible for any damages, loss of
  44. anticipated profits, or any other perceived loss related to using this
  45. program.  The user assumes the entire risk, and responsibility when using
  46. this program.
  47.  
  48.  
  49. ABOUT SHAREWARE:
  50. ---------------------------------------------------------------------
  51.  
  52. QED is SHAREWARE.  The registration fee is $20, and should be sent to:
  53.  
  54.                              Darren M. Greenwald
  55.  
  56.                          2511 W. Sunflower Av. #D-16
  57.                              Santa Ana, CA 92704
  58.  
  59.  
  60.  
  61.      Please include your name, address, and if you would like, a GEnie
  62. E-MAIL address where you can be reached.  The registration fee may be
  63. increased in the future.
  64.  
  65.      I can also be contacted on GEnie, E-MAIL address "DMG".  You are also
  66. invited to stop by the Amiga Programmer's RoundTable (PRO-AM) page 670.
  67.  
  68.      I would like to think that $20 is a very reasonable fee for software of
  69. this caliber.  The SHAREWARE method of distribution is less expensive then
  70. standard commercial distribution, and allows me to distribute updates
  71. quickly, and inexpensively.
  72.  
  73.  
  74.  
  75.      Registered owners will also receive:
  76.  
  77.      1.) Documentation describing the built in command line language, and
  78.          advanced features which are only accessable via the command line
  79.          language (e.g. insert multiple lines).
  80.  
  81.      2.) Documentation explaining how to write ARexx macros for use with QED.
  82.  
  83.      3.) Documentation explaining how to configure QED via an ARexx
  84.          start-up macro.
  85.  
  86.      4.) Documentation explaining how to create macros which are
  87.          automatically executed when a file is opened (based on the file
  88.          name's extension).
  89.  
  90.      5.) Documentation explaining how to configure the keyboard, and
  91.          function keys to execute QED commands, DOS commands, and/or ARexx
  92.          macros.
  93.  
  94.      6.) A disk containing the latest release of QED, and a number of
  95.          example macros.
  96.  
  97.      These capabilities allow you to extend QED's features, and create a
  98. customized working environment.  If you don't already have ARexx, I highly
  99. recommend you purchase it.  ARexx is a copyrighted program by William S.
  100. Hawes.
  101.  
  102.      Unfortunately, I will not be able to send free software updates to
  103. registered users due to the cost of mailing, however, software updates will
  104. be made available to registered users for a nominal fee to cover mailing
  105. and material costs.
  106.  
  107.  
  108. QED UPDATES:
  109. ---------------------------------------------------------------------
  110.  
  111.      Obviously it will be necessary to fix any bugs, finish any features
  112. not yet completed, and polish up those features which are functional.  Yet
  113. no matter how much work I do, chances are there will be some of you who
  114. would like additional features, and options.
  115.  
  116. !!! I do want to hear from you, but I also want to stress the following !!!
  117.  
  118.  
  119.    My philosophy on software is that a "good" piece of software does what
  120.    it is meant to do in a quick, and efficient manner.  This is
  121.    particularly true in the case of the Amiga in which programs do NOT have
  122.    to duplicate efforts.  For example, there is little point in adding DOS
  123.    support features to any program when the CLI, and/or Workbench
  124.    environment are available, and if you dont like those, you can run your
  125.    favorite directory utility as a separate task.    
  126.  
  127.    Some programs are built around the "bigger is better" philosophy, and in
  128.    the process of trying to do everything possible, such programs become so
  129.    large, and clumsy that they end up being useless except as a demo
  130.    program to awe your friends.
  131.  
  132.    The Amiga is "capable" of displaying IFF ILBM pictures, and
  133.    multiple fonts in a variety of styles.  Of course the Amiga is also
  134.    capable of displaying dual-playfield graphics, HAM mode graphics,
  135.    digitized sound effects, etc., none of which has any place in a text
  136.    editor!
  137.  
  138.    And while it would be possible to embelish QED with a variety of real
  139.    cute gadgets, and amazing sound effects, the thrill would quickly wear
  140.    off.  Then you could cherish the joy of watching your system ram being
  141.    eaten, your disk space clobbered, and best of all the thrill of waiting
  142.    forever while the program is loaded.
  143.  
  144.    If you make a request for a feature, be prepared to explain WHY you
  145.    need it.  There is no point in my wasting time on a feature that you
  146.    don't really need, and have no idea on how you plan to use it.
  147.  
  148.    Please don't request features because "some other program does it". 
  149.    Once again, if you don't need the feature, don't ask.  I want QED to
  150.    remain as small, fast, and as functional as possible.
  151.  
  152.    Requests for aesthetic changes will be considered, but once again, it is
  153.    simply not possible to please all of the people all of the time. 
  154.    I don't want QED to turn into a huge program primarily consisting of
  155.    support code to do nothing more then allow the user to make minor
  156.    aesthetic changes.
  157.  
  158.    Requests for emulations of other text editors will most likely be denied.
  159.    If you already have an editor which behaves in a certain manner, and
  160.    you like it, there is NO point in my writing additional code to emulate
  161.    another program which you already have.  However in many cases other
  162.    text editors can be emulated to a great degree by remapping the keyboard
  163.    to execute QED commands which are equivalent to a feature in another
  164.    text editor, and/or by creating ARexx macros which emulate the functions
  165.    of another text editor.
  166.  
  167.    Chances are I will be more willing to listen to you if you have paid
  168.    the registration fee.
  169.  
  170.  
  171. QED HIGHLIGHTS:
  172. ---------------------------------------------------------------------
  173.  
  174.  
  175.      QED is a very fast, full featured text editor for the Amiga written in
  176. Manx C, and 68000 assembly language.  QED offers a variety of options which
  177. allow you to customize how each text editing window behaves.  For example,
  178. QED has a free-form text editing mode which allows you to place the cursor
  179. anywhere on a line, and spaces are automatically inserted as needed.  Or if
  180. you prefer, QED can behave like a sequential file editor limiting cursor
  181. positioning to the end of a line.
  182.  
  183.      QED allows you to open multiple text editing windows with unique
  184. characteristics.  There is no built-in limit on the number of windows which
  185. can be opened other then memory limitations, and there is no significant
  186. performance penalty for opening multiple text editing windows other then
  187. what is normal for the operating system when managing multiple windows.
  188.  
  189.      Because of this multi-windowing capability, QED is much more efficient
  190. then text editors which can only handle one file at a time, and require you
  191. to run multiple copies of the text editor to edit multiple files.  Each new
  192. QED window requires roughly 3K of memory; 1K of which is allocated for an
  193. initial text editing buffer.  This figure does not include any additional
  194. CHIP ram required by the operating system to preserve clipped portions of
  195. windows.
  196.  
  197.      QED dynamically allocates, and deallocates memory as needed.  As you
  198. enter text, QED will automatically attempt to allocate more memory if
  199. needed.  Even the file requester dynamically allocates, and deallocates
  200. memory when reading directories.
  201.  
  202.      QED will work with non-proportional system fonts of any size with the
  203. understanding that fonts wider then Topaz 9, and/or taller then Topaz 11
  204. may be too large for use on a 640x200 Workbench screen.  This is because
  205. QED adjusts the size of the pull-down menus, and requesters to use your
  206. system font.
  207.  
  208.      Text rendering is extremely fast due to my built-in blitter based
  209. FastText rendering routine (copyright 1988-1989 by Darren M. Greenwald). 
  210. This routine speeds up rendering of non-proportional fonts of any height,
  211. and from 4-16 pixels wide.  At the time of this writing, this is the only
  212. routine that I am aware of which can make this claim.  All other existing
  213. fast text rendering routines for the Amiga only speed up rendering of 8x8
  214. pixel non-proportional fonts.
  215.  
  216.      QED allows you to open windows to the full size of your Workbench
  217. screen (e.g., larger screens using the MOREROWS utility), and decodes the
  218. alpha-numeric keys using your system's keymap (dead keys too).
  219.  
  220.      QED allows you to open, or insert very large files if needed, though
  221. in actual use it is recommended you work with files of a "reasonable" size.
  222.  There is no built-in limits on file size, line length, or number of lines
  223. per file other then what will fit into memory, however you should be aware
  224. that performance may be degraded if working with extremes.
  225.  
  226.      In most cases QED is extremely fast, however some time critical loops
  227. were written to take advantage of the 68010's 3 word instruction cache, so
  228. 68010 users should experience even faster performance.
  229.  
  230.      For example, QED has extremely fast search, and replace capabilities. 
  231. QED can search tens of thousands of characters per second, and replace
  232. approximately one thousand strings per second.   By comparison, many other
  233. text editors for the Amiga require many minutes to replace one thousand
  234. strings.  Search speed is not affected by non-case sensitive searches
  235. (which is a bit more complex then case-sensitive search mode).
  236.  
  237.      Memory is also used in an efficient manner.  Text is kept in memory in
  238. sequential format; lines of text are not padded with unused space, and
  239. memory is allocated in even 8K multiples to minimize memory fragmentation.
  240.  
  241.      QED uses a complete Intuition interface including pull-down menus,
  242. cursor positioning/scrolling via the mouse, input and message requesters,
  243. and a file requester.  Most of the pull-down menu selections, and
  244. requesters also allow you to use a keyboard alternative.
  245.  
  246.      Registered users will receive complete documentation describing the
  247. alternative command line mode.  The command line mode allows you to enter
  248. advanced commands not possible using the pull-down menus, and is essential
  249. if you want to customize QED, and write ARexx macros.
  250.  
  251.      Many operations can be limited to a marked block such as SAVE AS,
  252. PRINT, FORMAT, ERASE, and REPLACE.  QED allows you to mark entire lines of
  253. text, or if you prefer, from/to any row/column position.  Mark mode is
  254. completely transparent, and does not prevent you from editing text, or
  255. accessing the pull-down menus.
  256.  
  257.      A number of formatting tools are provided including simple word-wrap;
  258. adustable right margins (unique for each window); adjustable tab size
  259. (unique for each window); an extremely fast formatter which can format a
  260. paragraph or marked block of text; auto-indent; and a tool to indent a line
  261. or a range of lines to the next left/right tab position.
  262.  
  263.      A number of editing tools are available including block mark, cut,
  264. copy, and insert; line delete, delete to end of line, delete word, and
  265. undelete; split line at cursor position, join lines, and insert a new line
  266. with auto-indent; over-strike or insert mode.
  267.  
  268.      A number of cursor positioning tools are available including up/down a
  269. window page; next/previous word; end/beginning of line; end/beginning of
  270. file; go to a line; mark and go to a spot.
  271.  
  272.      And much more.... Please take the time to read through the user's
  273. documentation as there are many features that you may miss if you don't
  274. read this documentation.
  275.  
  276.